<?php

/**
 * @OA\Get(
 *   path="/api/sanctum/csrf-cookie",
 *   summary="CSRF保护（在登录前请求，从响应的 cookie 中获取 csrf-token）",
 *   operationId="csrf-cookie",
 *   tags={"authenticate"},
 *   @OA\Response(response=204, description="No Content")
 * )
 */

/**
 * @OA\Post(
 *   path="/api/login",
 *   summary="登录",
 *   operationId="post-login",
 *   tags={"authenticate"},
 *   @OA\Parameter(name="username", in="query", required=true, description="用户名", @OA\Schema(type="string", default="zhangpipi.o3o@gmail.com")),
 *   @OA\Parameter(name="password", in="query", required=true, description="密码", @OA\Schema(type="string", default="password")),
 *   @OA\Parameter(name="test", in="query", required=false, description="是否测试", @OA\Schema(type="integer", default="1")),
 *   @OA\Response(response=200, description="OK",
 *     @OA\JsonContent(type="object",
 *       @OA\Property(property="data", ref="#/components/schemas/Login")
 *     )
 *   ),
 *   @OA\Response(response=422, description="Unprocessable Entity"),
 *   @OA\Response(response=401, description="Unauthorized")
 * )
 */

/**
 * @OA\Get(
 *   path="/api/me",
 *   summary="个人信息",
 *   operationId="me",
 *   tags={"authenticate"},
 *   security={{"jwt": {}}},
 *   @OA\Response(response=200, description="OK",
 *     @OA\JsonContent(type="object",
 *       @OA\Property(property="data", ref="#/components/schemas/Me")
 *     )
 *   ),
 *   @OA\Response(response=401, description="Unauthorized")
 * )
 */

/**
 * @OA\Schema(
 *   schema="Login",
 *   @OA\Property(property="access_token", type="string", description="令牌"),
 *   @OA\Property(property="token_type", type="string", description="令牌类型")
 * )
 */

/**
 * @OA\Schema(
 *   schema="Me",
 *   @OA\Property(property="username", type="string", description="用户名"),
 *   @OA\Property(property="name", type="string", description="姓名"),
 *   @OA\Property(property="avatar", type="string", description="头像"),
 *   @OA\Property(property="uuid", type="string", description="UUID 用于websocket"),
 *   @OA\Property(property="ability", type="object", description="能力", ref="#/components/schemas/Ability"),
 * )
 *
 * @OA\Schema(
 *   schema="Ability",
 *   @OA\Property(property="total", type="string", description="总计分"),
 *   @OA\Property(property="explore", type="string", description="探索值"),
 *   @OA\Property(property="battle", type="string", description="战斗值"),
 *   @OA\Property(property="growth", type="string", description="成长值"),
 *   @OA\Property(property="student", type="string", description="学霸值"),
 *   @OA\Property(property="stamina", type="string", description="耐力值"),
 * )
 */
